Developer Documentation

QuickTime 4 API Documentation

QuickTime 4 Reference

| Previous | Chapter Contents | Chapter Top | Next |

Destinations for Output Images

These functions are used to specify destinations for output images.


GraphicsExportSetOutputDataReference

Returns the current output data reference.

pascal ComponentResult GraphicsExportSetOutputDataReference ( GraphicsExportComponent ci,
                                         Handle dataRef,
                                         OSType dataRefType);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
dataRef
A QuickTime data reference.
dataRefType
The data reference type.

GraphicsExportGetOutputDataReference

pascal ComponentResult GraphicsExportGetOutputDataReference ( GraphicsExportComponent ci,
                                         Handle *dataRef,
                                         OSType *dataRefType);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
dataRef
Points to a variable to receive the data reference handle.
dataRefType
Points to a variable to receive the data reference type.

The caller is responsible for disposing of the returned data reference handle.


GraphicsExportSetOutputFile

Defines the output file.

pascal ComponentResult GraphicsExportSetOutputFile (GraphicsExportComponent ci,
                                         const FSSpec *theFile);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
theFile
Identifies the file.

GraphicsExportGetOutputFile

Returns the current output file.

pascal ComponentResult GraphicsExportGetOutputFile (GraphicsExportComponent ci,
                                         FSSpec *theFile);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
theFile
Points to a variable to receive the FSSpec.

RESULT CODES

paramErr -50 The output is not a file.

GraphicsExportSetOutputHandle

pascal ComponentResult GraphicsExportSetOutputHandle (GraphicsExportComponent ci,
                                         Handle h);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
h
Specifies the output handle.

GraphicsExportGetOutputHandle

Returns the current output handle.

pascal ComponentResult GraphicsExportGetOutputHandle (GraphicsExportComponent ci,
                                         Handle *h);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
h
Points to a variable to receive the handle.

RESULT CODES

paramErr -50 The output is not a handle.

GraphicsExportSetOutputOffsetAndMaxSize

Specifies the output starting offset and maximum size limit.

pascal ComponentResult GraphicsExportSetOutputOffsetAndMaxSize ( GraphicsExportComponent ci,
                                         unsigned long offset,
                                         unsigned long maxSize,
                                         Boolean truncateFile);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
offset
The byte offset of the image data from the beginning of the data reference.
maxSize
A value describing the maximum size limit.
truncateFile
A Boolean value specifying whether to truncate the file.

GraphicsExportGetOutputOffsetAndMaxSize

Returns the output starting offset and maximum size limit.

pascal ComponentResult GraphicsExportGetOutputOffsetAndMaxSize ( GraphicsExportComponent ci,
                                         unsigned long *offset,
                                         unsigned long *maxSize,
                                         Boolean *truncateFile);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
offset
Receives a value describing the byte offset of the image data from the beginning of the data reference.
maxSize
Receives a value describing the maximum size limit.
truncateFile
Receives a Boolean value indicating whether to truncate the file.

If you are not interested in some of these pieces of information, you may pass nil .


GraphicsExportSetOutputFileTypeAndCreator

pascal ComponentResult GraphicsExportSetOutputFileTypeAndCreator ( GraphicsExportComponent ci,
                                         OSType fileType,
                                         OSType fileCreator);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
fileType
The file type for the new image file, such as `JPEG' .
fileCreator
The file creator for the new image file. This parameter may be 0, in which case a default file creator for this file type is used.

GraphicsExportGetOutputFileTypeAndCreator

pascal ComponentResult GraphicsExportGetOutputFileTypeAndCreator ( GraphicsExportComponent ci,
                                         OSType *fileType,
                                         OSType *fileCreator);
ci
Specifies the component instance that identifies your connection to the graphics exporter component.
fileType
Receives the file type for the new image file.
fileCreator
Receives the file creator for the new image file.

© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |